String.split()

Доступность

Flash Player 5.

Синтаксис

my_str.split("delimiter":String, [limit:Number]) : Number

Параметры

delimiter Строка; символ или последовательность символов, каким должна разбиваться строка my_str .

limit Число; число элементов размещаемых в массив. Это дополнительный параметр.

Возвращает

Массив; массив, содержащий подстроки my_str.

Описание

Метод; разбивает объект String на подстроки там, где встречается указанный параметр delimiter и возвращает массив подстрок. Если используется пустая строка("") как разделитель, каждый символ будет помещен в отдельный элемент массива.

Если параметр delimiter не определён, строка целиком будет помещена в первый элемент возвращаемого массива.

Пример

В следующем примере возвращается массив с пятью элементами :

var my_str:String = "P,A,T,S,Y";
var my_array:Array = my_str.split(",");
for (var i = 0; i<my_array.length; i++) {
  trace(my_array[i]);
}
/* выводится:
  P
  A
  T
  S
  Y
*/

Пример возврата массива с двумя элементами, "P" и "A":

var my_str:String = "P,A,T,S,Y";
var my_array:Array = my_str.split(",", 2);
trace(my_array); // выводится: P,A

В этом примере показано, что если вы используете пустую строку ("") как параметр delimiter , каждый символ строки будет помещен в соответствующий элемент массива :

var my_str:String = new String("Joe");
var my_array:Array = my_str.split("");
for (var i = 0; i<my_array.length; i++) {
  trace(my_array[i]);
}
/* выводится:
  J
  o
  e
*/

Некоторые примеры есть также в файле Strings.fla папки HelpExamples . В списке даны примерные пути к этой папке :

См.также

Array.join()